home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / nroff1.zip / NRO.MAN < prev    next >
Text File  |  1990-11-25  |  14KB  |  331 lines
  1.  
  2.      NRO (1)                    Unix V7 Version                     NRO (1)
  3.  
  4.  
  5.  
  6.      NAME 
  7.           nro - text processor 
  8.  
  9.      SYNOPSIS 
  10.           nro  [-n]  [+n]  [-pxx]  [-v]  [-u] [-b] [-mmfile] ifile ...
  11.           [>ofile] 
  12.  
  13.      DESCRIPTION 
  14.           NRO is a text processor and formatter based  on  the  design
  15.           provided in  "Software Tools" by Kernighan and Plauger.  The 
  16.           text  and  commands  found  in the ifile(s) are processed to
  17.           generate formatted text.  The output may be directed into  a
  18.           file or to the printer, otherwise, the output will appear at 
  19.           the user console.  
  20.  
  21.           The +n  option  causes the output to start with page n.  The
  22.           -n option causes the output to stop after page n.  
  23.  
  24.           The -v option prints the version number to the console.  
  25.  
  26.           The -p option causes the output to be shifted to  the  right
  27.           by xx spaces.  This has the same effect as the .po command.  
  28.  
  29.           The  -u option enables underlining and bold to appear in the
  30.           output text.  
  31.  
  32.           The -b option allows backspaces to be used when  underlining
  33.           or overstriking.     Otherwise  a  carriage  return  without
  34.           linefeed is used.   This has the  same  effect  as  the  .bs
  35.           command with a non-zero argument.  
  36.  
  37.           The   -m   option   processes   the  file  mfile  for  macro
  38.           definitions.  Note that files processed in this  way  should
  39.           contain  only  macro definitions, no immediate output should
  40.           be generated from this file.  
  41.  
  42.           Commands typically are distinguished by a period  in  column
  43.           one  of  the  input followed by a two character abbreviation
  44.           for the command funtion.    The  abbreviation  may  then  be
  45.           followed by  an optional numeric or character argument.  The
  46.           numeric argument may be an absolute value  such  as  setting
  47.           the right margin to a particular column, or the argument may 
  48.           be  preceded by a plus sign or a minus sign to indicate that
  49.           the parameter should be  modified  relative  to  a  previous
  50.           setting.  The following commands are recognized: 
  51.  
  52.           .bo - causes the following lines of text to appear in 
  53.                 boldface.  The optional argument specifies the number 
  54.                 of lines to be typed in boldface.  Boldface and 
  55.                 underlining are mutually exclusive features.  The 
  56.                 appearance of a boldface command will cause any 
  57.                 underlining to cease.  
  58.  
  59.           .bp - causes succeeding text to appear at the top of a new 
  60.                 page.  The optional argument specifies the page number 
  61.                 for the new page.  The initial value is one and the 
  62.                 default value is one more than the previous page 
  63.  
  64.  
  65.                                       -1-
  66.  
  67.  
  68.      NRO (1)                    Unix V7 Version                     NRO (1)
  69.  
  70.  
  71.                 number.  
  72.  
  73.           .br - causes succeeding text to start on a new line at the 
  74.                 current left margin.  There is no numeric argument for 
  75.                 this command.  
  76.  
  77.           .bs - enables or disables the appearance of backspaces in 
  78.                 the output text.  Underlining and boldface options are 
  79.                 implemented by inserting character - backspace - 
  80.                 character combinations into the output buffer.  This 
  81.                 is fine for devices which properly recognize the 
  82.                 backspace character.  Some printers, however, do not 
  83.                 recognize backspaces, so the option is provided to 
  84.                 overprint one line buffer with another.  The first 
  85.                 line buffer is terminated with just a carriage return 
  86.                 rather than the carriage return - linefeed 
  87.                 combination.  A zero argument or no argument to the 
  88.                 backspace command removes backspaces from the output.  
  89.                 A non-zero argument leaves them in the output.  The 
  90.                 default is to remove backspaces.  
  91.  
  92.           .cc - changes the NRO command character to that specified by 
  93.                 the character argument.  If no argument is provided, 
  94.                 the default is a period.  
  95.  
  96.           .ce - causes the next line of text to appear centered on the 
  97.                 output.  The optional argument specifies if more than 
  98.                 one line is to be centered.  
  99.  
  100.           .de - causes all text and commands following to be used to 
  101.                 define a macro.  The definition is terminated by a .en 
  102.                 command.  The first two characters of the argument 
  103.                 following the .de command become the name of the new 
  104.                 command.  It should be noted that upper and lower case 
  105.                 arguments are considered different.  Thus, the 
  106.                 commands .PP and .pp could define two different 
  107.                 macros.  Care should be exercised since existing 
  108.                 commands may be redefined.  
  109.  
  110.                 A macro may contain up to ten arguments.  In the macro 
  111.                 definition, the placement of arguments is designated 
  112.                 by the two character sequences, $0, $1, ... $9.  When 
  113.                 the macro is invoked, each argument of the macro 
  114.                 command line is substituted for its corresponding 
  115.                 designator in the expansion.  The first argument of 
  116.                 the macro command is substituted for the $0 in the 
  117.                 expansion, the second argument for the $1, and so 
  118.                 forth.  Arguments are typically strings which do not 
  119.                 contain blanks or tabs.  If an argument is to contain 
  120.                 blanks, then it should be surrounded by either single 
  121.                 or double quotes.  
  122.  
  123.           .cu - causes the next line(s) of text to be continuously 
  124.                 underlined.  Unlike the underline command (see .ul) 
  125.                 which underlines only alphanumerics, continuous 
  126.                 underlining underlines all printable characters.  The 
  127.                 optional argument specifies the number of lines of 
  128.                 text to underlined.  Any normal underlining or 
  129.  
  130.  
  131.                                       -2-
  132.  
  133.  
  134.      NRO (1)                    Unix V7 Version                     NRO (1)
  135.  
  136.  
  137.                 boldface commands currently in effect will be 
  138.                 terminated.  
  139.  
  140.           .ef - specifies the text for the footer on even numbered 
  141.                 pages.  The format is the same as for the footer 
  142.                 command (see .fo).  
  143.  
  144.           .eh - specifies the text for the header on even numbered 
  145.                 pages.  The format is the same as for the footer 
  146.                 command (see .fo).  
  147.  
  148.           .en - designates the end of a macro definition.  
  149.  
  150.           .fi - causes the input text to be rearranged or filled to 
  151.                 obtain the maximum word count possible between the 
  152.                 previously set left and right margins.  No argument is 
  153.                 expected.  
  154.  
  155.           .fo - specifies text to be used for a footer.  The footer 
  156.                 text contains three strings seperated by a delimiter 
  157.                 character.  The first non-blank character following 
  158.                 the command is designated as the delimiter.  The first 
  159.                 text string is left justified to the current 
  160.                 indentation value (specified by .in).  The second 
  161.                 string is centered between the current indentation 
  162.                 value and the current right margin value (specified by 
  163.                 .rm).  The third string is right justified to the 
  164.                 current right margin value.  The absence of footer 
  165.                 text will result in the footer being printed as one 
  166.                 blank line.  The presence of the page number character 
  167.                 (set b